home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / zmsg2b3.zip / ZMESSAGE.DOC < prev    next >
Text File  |  1996-02-06  |  33KB  |  821 lines
  1.               The Ultimate BBS List
  2.              version 2.0b3 Wide Beta
  3.                  by KS\ Software
  4.  
  5.  
  6.  
  7.  
  8.  
  9. =====================================================================
  10. 1                       WARRANTEE INFORMATION
  11. =====================================================================
  12.  
  13.     ZMessage is distributed AS IS with NO warranty, neither expressed
  14. nor implied. In no event will Kurt Schultz or KS\ Software be held 
  15. liable to you for any damages, expenses or loss of profits or savings 
  16. that may occur through the use of or inability to use this program. You,
  17. the user agree to use this program at your own risk. Extensive testing 
  18. has been performed to ensure satisfactory performance prior to release. 
  19. However, ZMessage is only gauranteed to use up hard disk space.  
  20.  
  21. =======================================================================
  22. 2                           LEGAL STUFF
  23. =======================================================================
  24.        
  25.     ZMessage is ShareWare and as such is protected under US Federal 
  26. Copyright Laws.  You are granted license to use this program for 
  27. evaluation purposes for a period of 30 days. At the end of 30 days, 
  28. you must either register ZMessage or remove it from your system and 
  29. discontinue its use. If you continue to use ZMessage past the 30 day 
  30. evaluation period without registering, you will be in violation of US 
  31. Federal Copyright Laws. 
  32.  
  33.     PLEASE DISTRIBUTE THIS PROGRAM!!!!! You may distribute the ShareWare
  34. version of Zmessage as much as you like, in fact I URGE you to upload 
  35. this archive to every system you call!  I only ask that you do not alter
  36. any of the files contained within this archive without express permission 
  37. from me.
  38.  
  39. ==========================================================================
  40. 3                        GETTING AHOLD OF ME
  41. ==========================================================================
  42.  
  43.       If you need to get ahold of me for any reason, I can be reached 
  44. via E-Mail at the following:
  45.  
  46. FidoNet:             InterNet:                America Online:
  47. 1:3634/406           moutanman@aol.com        Moutan Man
  48.  
  49. and Snail Mail:
  50. Kurt Schultz
  51. PO BOX 341
  52. Parkton, NC 28371
  53.  
  54.  
  55.  
  56. ==========================================================================
  57. 4                              INTRODUCTION
  58. ==========================================================================
  59.  
  60.         ZMessage is a multi-node capable auto message door  written 
  61. in an attempt to create a nicer looking Auto Message door than the 
  62. usual "blue boxes" containing text. Users can leave a 2-line message 
  63. that other users will see at logon.  Once the maximum number of messages
  64. is reached, the oldest message will be paged out of the data file as new
  65. ones are added. It supports User selectable message color with support 
  66. for embedding several colors within the message body. Users can post 
  67. messages using Anonymous, their Real Name or their Handle.
  68.  
  69.  
  70.      ZMessage has 2 modes of operation: Logon and Normal.  In Logon
  71. mode, ZMessage will display messages left by others then ask the user if
  72. they want to leave a message.  It will then return to the BBS after the 
  73. user leaves a message or selects not to leave a message. (The usual 
  74. automessage door mode) In Normal mode, ZMessage performs as a regular 
  75. door displaying a menu of choices ( Add message, View messages, Logoff,
  76. and Quit to BBS ) Each time the user finishes viewing or adding messages,
  77. they are returned to the menu until they select logoff or quit to BBS. 
  78. This offers the ability for Zmessage to match up seamlessly to your BBS
  79. as if it were a part of the host.
  80.  
  81.         All ANSI/Avatar/ASCII/RIP screens can be customized to your liking
  82. in both the registered and unregistered versions.  See CUSTOMIZING THE
  83. SCREENS for details.
  84.  
  85.  
  86. <<<<<<<<<<< A QUICK PLUG FOR OPEN DOORS BY Brian Pirie >>>>>>>>>>>>>>>
  87.  
  88.        ZMessage was written in C using the Open Doors Library by Brian 
  89. Pirie. <Thanks Brian for an EXCELENT programming library>.  Open doors 
  90. version 5.0 can be found on most BBS's filename ODOORS50.ZIP.  I highly
  91. recommend this library over any other!
  92.  
  93. <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  94.  
  95. ZMessage supports dropfile formats from most major bbs packages, and 
  96. automatically senses which format is present.
  97.  
  98. Supported formats are shown below:
  99.  
  100. +-----------------------------+
  101. | DORINFO?.DEF                |
  102. | EXITINFO.BBS (normal)       |
  103. | EXITINFO.BBS (extended) RA  |
  104. | EXITINFO.BBS (Quick BBS)    |
  105. | CHAIN.TXT                   |
  106. | SFDOORS.DAT                 |
  107. | CALLINFO.BBS                |
  108. | DOOR.SYS (GAP/PC-Board)     |
  109. | DOOR.SYS (doorway style)    |
  110. | DOOR.SYS (WildCat)          |
  111. | Custom (SysOp defined)      |
  112. +_____________________________+
  113.  
  114.     If your BBS software does  not support one of the above formats,
  115. you can use the configuration file to configure ZMessage to use your 
  116. BBS's dropfile format!  For more informatin regarding custom dropfile 
  117. setup, refer to the section titled "The Configuration File".
  118.  
  119.     ZMessage is fully SysOp configurable.  The configuration file 
  120. permits you to customize the performance of ZMessage to your own 
  121. preferences.  Among settings available are system directories, screen 
  122. colors, maximum time permitted, memory swapping options, and more.
  123.  
  124.      This version of ZMessage is now multi-node aware! I have not been 
  125. able to fully test multi-node operation yet.  However, ZMessage is 
  126. multi-node aware and should have no problem running under a multi-node
  127. setup.
  128.  
  129.      The only crippling I have set is a limit of 3  auto-messages and a
  130. 10 second delay with a message stating that you are an Unregistered 
  131. BBS on exit.  And of course, if you don't register, Aliens will suck 
  132. your brain. Registration will remove the nasty things.
  133.  
  134. Registration is only $10.00.  This is a one time registration fee, your
  135. key code will work on all future versions of ZMessage.  So why not 
  136. register right? <g>
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143. =======================================================================
  144. 5                     FILES IN THIS ARCHIVE
  145. =======================================================================
  146.  
  147.     The following files should be included in this archive:
  148.  
  149.     ZMESSAGE.EXE       The Program
  150.     ZMESSAGE.CFG       A heavily commented configuration file
  151.     ZMESSAGE.DOC       This file
  152.     ZMESSAGE.DAT       The Data file <created when you run Zmessage>
  153.     ZLOGO.ANS/RIP      The Logo at the top of the screen when messages are
  154.                        displayed.
  155.     ZMENU.ANS/ASC/RIP  The background image for the Menu display.
  156.     ZADD.ANS/RIP       The Screen you see when adding messages.
  157.     DOOR.SYS           A door.sys file for testing
  158.     REGISTER.FRM       The Registration Form.
  159.     RENSETUP.DOC       A document by HereticX16 for help setting up Zmessage
  160.                        on Renegade BBS
  161.  
  162. <<<<<<<< IMPORTANT >>>>>>>>>
  163.     DELETE THE DOOR.SYS FILE PRIOR TO INSTALLING ZMESSAGE ON YOUR BBS.
  164.     THE DOOR.SYS FILE IS ONLY FOR YOUR CONVENIENCE IN TESTING.
  165.  
  166.  
  167.  
  168. =============================================================================
  169. 6                        CUSTOMIZING THE SCREENS
  170. =============================================================================
  171.     You can customize all the screens in ZMessage with an ansi editor.
  172. You can use TheDraw, Aciddraw or any other Ansi editor to edit ZMENU.ANS
  173. ZLOGO.ANS and ZADD.ANS to customize ZMessage for you BBS. The only
  174. limitations are detailed below.
  175.  
  176.     In addition to the ANSI and RIP screens, Zmessage also supports avatar
  177. format, however, no avatar screens are included in this archive.  To add 
  178. Avatar screens to Zmessage, all you need to do is create an avatar screen 
  179. for each screen and name them with the extension .AVT (ie. ZLOGO.AVT)
  180. If a user has Avatar emulation, Zmessage will automatically send the Avatar
  181. screen instead of Ansi or RIP.
  182.  
  183. ZLOGO.ANS
  184.      The top 6 lines of the screen when messages are displayed are from
  185. this file.  Messages are scrolled below this screen so the logo will
  186. stay up at all times.  ZLOGO.ANS must not be any longer than 6 lines.
  187. Otherwise it will be scrolled off the top of the screen initially and 
  188. if it is too long, the message scrolling  routine will destroy anything
  189. below line 6.
  190.  
  191. ZLOGO.RIP
  192.      This file is the RIP version of ZLOGO.ANS.  ZLOGO.RIP requires a text
  193. Window for displaying of the messages.  It is important not to let any
  194. button you place on it to reset the screen unless it is for answering "NO" 
  195. to adding messages.
  196.  
  197. ZADD.ANS
  198.    This ansi can be up to 23 lines long.  The only limitation is that
  199. the text in this part of the program has a black background, so you
  200. would need to allow an area of no graphics for the text like the current
  201. screen.
  202.  
  203. ZADD.RIP
  204.     This rip requires a text window for the add message and verify routines.
  205. It is only important to remember NOT to let your buttons reset the screen.
  206. The command specified in the "change/select colors" button is ^[ the RIP 
  207. equivalent to <esc>.
  208.  
  209. ZMENU.ANS
  210.    This is a 19 line ansi, all you would need to do is ensure you use
  211. an ascii editor to delete all carriage returns padded in by TheDraw.
  212. The actual menu is displayed via a popup window.  You can draw whatever
  213. you want and the menu will popup over the top of the screen.  A neat
  214. implementation that I haven't had time to implement yet would be to
  215. draw an ansi that appears to wrap around the popup window.
  216.  
  217. ZMENU.RIP
  218.    The RIP version of ZMENU.ANS.  No Text window is required for this RIP 
  219. and any buttons can reset the window.
  220.  
  221. ZMENU.ASC
  222.    This is the actual ascii menu.  All choices are included in the
  223. screen. You can customize this one to give the ASCII side of ZMessage
  224. the same look and feel as your BBS.
  225.  
  226. =====================================================================
  227. 7                  COMMAND-LINE PARAMETERS
  228. ====================================================================
  229.  
  230.         Zmessage accepts several command-line parameters to allow for
  231. setting of node specific parameters such the path to the dropfile and
  232. odd IRQ/COM Port settings.  The parameters available are listed below.
  233.  
  234.  
  235. DROPFILE PATH  This is the location of your drop file IE C:\BBS or
  236.                whatever directory that contains the dropfile for the
  237.                node calling Zmessage. THIS MUST BE THE FIRST PARAMETER
  238.                IN ALL CALLS TO ZMESSAGE.
  239.  
  240. LOGON          Optional parameter tells Zmessage to operate in LOGON
  241.                mode. When LOGON is specified, Zmessage will display all
  242.                messages, then ask the user if they wish to add a message.
  243.                They may then enter a message or answer "no" and be returned
  244.                to the BBS.  If they decide to add a message, they will be
  245.                returned to the BBS after adding the message.
  246.  
  247. NOFOSSIL       This parameter, forces Zmessage to use Internal COM
  248.                routines instead of using a FOSSIL driver.  Zmessage
  249.                will default to FOSSIL routines unless this parameter is
  250.                passed.
  251.  
  252. L:x            Where x = Locked BPS rate.  This parameter is normally
  253.                obtained from your bbs dropfile and not required.  It is
  254.                only included to allow systems that do not report the
  255.                locked port BPS rate to set it via the command line.
  256.  
  257. THE FOLLOWING PARAMETERS ARE ONLY REQUIRED IF YOU ARE USING ODD IRQ's OR
  258. COM PORTS AND NOT USING A FOSSIL DRIVER.
  259.  
  260. ADDRESS:x      Where x = the hexidecimal address of the COM port.
  261.                Sets the hexidecimal address of the COM port (eg. 2F8)
  262.                This parameter is only required if you are NOT using a
  263.                FOSSIL driver and are using COM5 or higher
  264.  
  265. IRQ:x          Where x = IRQ number 1-15. Sets the IRQ number of the COM
  266.                port.  This parameter is only required if you are using
  267.                COM5 or higher or have your COM1-4 set to a different IRQ
  268.                setting then the default of IRQ 4 for COM1 & COM3 and IRQ 3
  269.                for COM2 & COM4.
  270.  
  271.    For example, to call Zmessage for logon mode using internal comm
  272. routines with the dropfile located in the C:\bbs\node1 directory, the
  273. command line syntax would be as follows:
  274.  
  275.    ZMESSAGE.EXE C:\BBS\NODE1 LOGON NOFOSSIL
  276.                    /|\
  277.                     |_____The dropfile path MUST be the first parameter.
  278.  
  279.    
  280. ===========================================================================
  281.  8                          INSTALLATION
  282. ===========================================================================
  283.  
  284.    ZMESSAGE NO LONGER REQUIRES A FOSSIL DRIVER TO BE LOADED AND
  285.    ACTIVATED TO WORK.  IT NOW HAS ITS OWN INTERNAL COMM ROUTINES BUT
  286.    STILL SUPPORTS A FOSSIL AS THE DEFAULT SET UP.
  287.  
  288.    This version is not compatable with ZMessage 1.x.  To upgrade to
  289. 2.x from a 1.x version of ZMessage, completely overwrite everything in
  290. your old Zmessage directory. Then DELETE the ZMESSAGE.DAT file along
  291. with the following files ZSCREEN.* and ZOK.*. All future versions of
  292. Zmessage will be compatible with the 2.x data file.
  293.  
  294.  
  295. To install ZMessage on your system, do the following:
  296.  
  297.    1. READ the section above entitles COMMAND-LINE PARAMETERS!
  298.  
  299.    2. Unzip this archive into a directory of your choice.
  300.  
  301.    3. Edit ZMESSAGE.CFG and set any configuration options you wish.
  302.       
  303.    4. Set up your BBS to call ZMESSAGE.EXE with appropriate parameters
  304.       at logon.
  305.       for example:
  306.                    ZMESSAGE C:\BBS\NODE1 LOGON
  307.       Will call Zmessage in logon mode using your FOSSIL driver.
  308.       
  309.       With GAP BBS you would do this by creating a batch file called 
  310.       LOGON.BAT that calls Zmessage from that batch file.  For other
  311.       BBS Software, you will need to consult the Docs for that BBS.
  312.  
  313.  
  314.    5. Set up ZMessage as a door on your BBS and configure your BBS to
  315.       call it with without the LOGON parameter. ZMessage will default
  316.       to "NORMAL" door operation with the menu routine.
  317.       for example:
  318.                     ZMESSAGE C:\BBS\NODE1 NOFOSSIL
  319.       Will call Zmessage in normal "door" mode using internal com
  320.       routines.
  321.  
  322.    6. Logon to your BBS and see ZMessage from your BBS.
  323.  
  324.    EXAMPLE BATCH FILE FOR LOGON OPERATION
  325.  
  326.    <<< LOGON.BAT >>>
  327.  
  328.    ECHO OFF
  329.    C:
  330.    CD\BBS\ZMESSAGE
  331.    ZMESSAGE C:\BBS LOGON
  332.  
  333.    CD\BBS
  334.  
  335.  
  336.  
  337.    ZMessage will automatically check the directory specified in the
  338. for the dropfile and detect which dropfile type is present.
  339.  
  340.    EXAMPLE BATCH FILE FOR DOOR OPERATION < Menu Interface >
  341.  
  342.    <<< ZMESSAGE.BAT >>>
  343.  
  344.   ECHO OFF
  345.   C:
  346.   CD\BBS\ZMESSAGE
  347.   ZMESSAGE C:\BBS
  348.  
  349.   CD\BBS
  350.  
  351.  
  352.  
  353. ======================================================================
  354. 9                     MULTI-NODE OPERATION
  355. ======================================================================
  356.  
  357. The easiest way to implement multi-node operation is to have a "NODE"
  358. environment variable set by the batch file that initialy starts your bbs
  359. software.  You can then use the NODE variable to control flow in your
  360. ZMESSAGE.BAT file and write just one batch for all nodes.  An example
  361. below.
  362. For my BBS, the batch that initially starts up the BBS for node1 is none
  363. other than NODE1.BAT.  NODE1.BAT sets basic environment variables then
  364. calls GAP.BAT which is the cycling batch file that keeps the BBS running
  365. after each call.
  366.  
  367. -------------------------------------------------------------------
  368. NODE1.BAT
  369. @ECHO OFF
  370.  
  371. REM This line sets the %NODE% variable to 1
  372. SET NODE=1
  373. REM The next line sets the path to dszlog.
  374. SET DSZLOG=C:\GAP\NODE1\DSZLOG.
  375.  
  376. REM this line starts the cycling batch file to run the bbs
  377. D:
  378. CD\GAP\NODE1
  379. GAP
  380. -------------------------------------------------------------------
  381. ZMESSAGE.BAT
  382. @ECHO OFF
  383. REM change to the zmessage directory
  384. D:
  385. CD\GAP\DOORS\ZMESSAGE
  386.  
  387. REM IF the NODE variable = 1 goto the node1 part
  388. REM IF the NODE variable = 2 goto the node2 part
  389. IF %NODE% == 1 GOTO NODE1
  390. IF %NODE% == 2 GOTO NODE2
  391.  
  392. REM this is where we end up if node is 1
  393. :NODE1
  394. ZMESSAGE D:\GAP\NODE1 NOFOSSIL
  395. GOTO END
  396.  
  397. REM this is where we end up if node is 2
  398. :NODE2
  399. ZMESSAGE D:\GAP\NODE2 NOFOSSIL
  400. GOTO END
  401.  
  402. REM After Zmessage runs we are sent here to chang back to the
  403. REM directory for the bbs node and restart the bbs.
  404. :END
  405. D:
  406. CD\GAP\NODE%NODE%
  407.  
  408. REM as you can see above the value of %NODE% is appended to
  409. REM whatever you stick it on
  410.  
  411.  
  412. ======================================================================
  413. 10                    THE CONFIGURATION FILE
  414. ======================================================================
  415.  
  416.    The configuration file included in this archive is heavilly 
  417. commented and you should have no problem setting up your own custom
  418. configurations. The format for the configuration file is as follows.  
  419. Blank lines and any text following a semi-colon are ignored.  
  420. Configuration options are specified using a key word possibly followed
  421. by one or more options.  The keywords are not case sensitive but some
  422. of the options are.  The order of options in the configuration file is
  423. not significant. The configuration options are detailed in the file.
  424.  
  425. ; ZMessage.CFG - Sample door configuration file
  426. ;
  427. ;
  428. ; Any text following a semi-colon (;), and blank lines, are ignored.
  429. ;
  430. ;---------------------------------------------------------------------
  431. ;
  432. ; The door's working directory. This is where the door's system files
  433. ; are located. Remove the semi-colon (;) to activate this option.
  434. ;
  435. ;DoorDir    C:\BBS\ZMESSAGE
  436. ;
  437. ;----------------------------------------------------------------------
  438. ;
  439. ; Local mode override. Forces door to always operate in local test mode.
  440. ; Remove the semi-colon (;) to activate this option. When this mode is
  441. ; activated, no door information file is required and default settings
  442. ; used for the user's name, location, etc.
  443. ;
  444. ;LocalMode
  445. ;
  446. ;----------------------------------------------------------------------
  447. ;
  448. ;  Door personality setting. This setting selects one of a number of;
  449. ;  sysop interface personalities. Each personality setting emulates
  450. ;  the status line format and sysop function keys of a particular BBS
  451. ;  package. Valid personality settings are:
  452. ;
  453. ;                     Standard (Open Doors style, similar to RA 1.11)
  454. ;                     PCBoard
  455. ;                     RemoteAccess
  456. ;                     Wildcat
  457. ;
  458. Personality    Standard
  459. ;
  460. ;---------------------------------------------------------------------
  461. ;
  462. ;  Log File options. "LogFileName" specifies filename (path optional)
  463. ;  where the door should record log information. To disable the log 
  464. ;  file altogether, remove the semi-colon (;) from the "DisableLogging"
  465. ;  line.
  466. ;
  467. ;LogFileName    DOOR.LOG
  468. ;DisableLogging
  469. ;
  470. ;------------------------------------------------------------------------
  471. ;
  472. ;
  473. ;  Maximum length of time a user is permitted to access the door. 
  474. ;  If the user's total remaining time on the BBS is less than this value
  475. ;  the user will only be permitted to access the door for this shorter 
  476. ;  length of time. This option may be disabled by placing a semi-colon
  477. ;  (;) at the beginning of the line. When this option is disabled, the 
  478. ;  user will be permitted to use the full of their remaining time on the
  479. ;  BBS within the door.
  480. ;
  481. ;MaximumDoorTime    15
  482. ;
  483. ;-------------------------------------------------------------------------
  484. ;
  485. ;  Inactivity timeout. Specifies the maximum number of seconds that may 
  486. ;  elapse without the user pressing any key, before the user will be
  487. ;  automatically disconnected. A value of 0 disables inactivity 
  488. ;  timeouts.
  489. ;
  490. InactivityTimeout    200
  491. ;
  492. ;-----------------------------------------------------------------------
  493. ;  Maximum messages allowed.  The maximum number of messages that 
  494. ;  Zmessage will allow before paging out the oldest message is set 
  495. ;  here.  Set this to a value from 1 to 12.
  496. ;
  497. maxMessages 3
  498. ;  
  499. ;  User Security Level not allowed to post.  This option allows you to
  500. ;  restrict users of a certain level and below from adding messages to 
  501. ;  the wall.  The line below would restrict all users, access level 10
  502. ;  and below from being able to enter messages.
  503. ;
  504. NoPost 10
  505. ;-----------------------------------------------------------------------
  506. ;  Registration Information:  Set the following to your Name exaclty
  507. ;  as it appears in your registration conformation and registration 
  508. ;  code.
  509. ;
  510. RegisteredTo Unregistered
  511. RegistrationKey 000000000
  512. ;
  513. ;------------------------------------------------------------------------
  514. ;  Name of the sysop. ZMESSAGE can usually determine the sysop's name 
  515. ;  from theinformation passed to the door by the BBS. However, some BBS
  516. ;  software does not supply this information to doors. In such cases, if
  517. ;  the sysop's name is required by the door, it may be supplied here. 
  518. ;  Remove the semi-colon (;) to activate this option.
  519. ;
  520. ;SysopName    The Sysop
  521. ;
  522. ;------------------------------------------------------------------------
  523. ;
  524. ;  Name of the BBS. ZMESSAGE can usually determine the name of the BBS 
  525. ;  from the information passed to the door by the BBS. However, some 
  526. ;  BBS software does not supply this information to door programs. In
  527. ;  such cases, if the name of the BBS is needed by the door, it may be
  528. ;  supplied here. Remove the semi-colon (;) to activate this option.
  529. ;
  530. ;SystemName    Unnamed BBS
  531. ;
  532. ;------------------------------------------------------------------------
  533. ;
  534. ;  Door colour options. These options specify the various text colors
  535. ;  that will be used by the door if ANSI or AVATAR graphics modes are
  536. ;  available. Colors are specified in the format:
  537. ;
  538. ;         {Bright} {Flashing} [Foreground Color] on [Background Color]
  539. ;
  540. ;  Where foreground and background colors are one of:
  541. ;
  542. ;         Black
  543. ;         Blue
  544. ;         Green
  545. ;         Cyan
  546. ;         Red
  547. ;         Magenta
  548. ;         Yellow / Brown
  549. ;         White / Grey
  550. ;
  551. ;  Note that some of these options (such as those that pertain to files
  552. ;  listings) are not used for all doors.
  553. ;
  554. ChatUserColour               Bright white on black
  555. ChatSysopColour              Bright red on black
  556. ;
  557. ;------------------------------------------------------------------------
  558. ;
  559. ;  Memory swapping options. These options are generally not needed, 
  560. ;  but can be used to customize OpenDoor's swapping behaviour. 
  561. ;  "SwappingDir" can be used to specify which directory or directories 
  562. ;  should be used for swapping. Multiple directory paths can be 
  563. ;  seperatedusing a semi-colon. "SwappingNoEMS" can be used to prevent
  564. ;  any swapping from being done to EMS memory, and "SwappingDisable"
  565. ;  can be used to disable memory swapping altogether. Remove the semi-
  566. ;  colon (;) to activate any of these options.
  567. ;
  568. ;SwappingDir    C:\
  569. ;SwappingNoEMS
  570. ;SwappingDisable
  571. ;
  572. ;----------------------------------------------------------------------
  573. ;  The following options only apply if a FOSSIL driver is NOT being used
  574. ;  for serial communications.  These options are normally set in the
  575. ;  FOSSIL command line.
  576. ;
  577. ;
  578. ;  Serial I/O buffer sizes. "ReceiveBuffer" specifies the number of bytes in
  579. ;  the serial I/O receive buffer. You may want to increase this buffer size
  580. ;  if you find that characters being sent from the user's modem are being lost.
  581. ;  "TransmitBuffer" specifies the number of bytes in the serial I/O transmit
  582. ;  buffer. You may want to increase this buffer size for improved performance
  583. ;  in some multitasking environments.
  584. ;
  585. ReceiveBuffer 256
  586. TransmitBuffer 1024
  587. ;
  588. ;
  589. ;  UART FIFO buffers. Normally, ZMESSAGE will use 16550A UART FIFO buffers
  590. ;  if they are available. You can prevent ZMESSAGE from using the FIFO
  591. ;  buffers, even if they are available, by removing the semi-colon before
  592. ;  the "NoFIFO" keyword. The "FIFOTriggerSize" specifies how many characters
  593. ;  may be placed in the FIFO buffers before an serial I/O interrupt is
  594. ;  envoked. Valid values are 1, 4, 8 and 14 bytes. The default value is 4
  595. ;  bytes.
  596. ;
  597. ;NoFIFO
  598. FIFOTriggerSize 4
  599. ;
  600. ;------------------------------------------------------------------------------
  601. ;
  602. ;  Custom door information file support. ZMESSAGE automatically recognizes
  603. ;  most door information file (drop file) formats, including DORINFO?.DEF,
  604. ;  EXITINFO.BBS, DOOR.SYS, SFDOORS.DAT, CALLINFO.BBS and CHAIN.TXT. However,
  605. ;  to permit ZMESSAGE doors to operate on BBS systems that produce a different
  606. ;  format file, you may define a custom door information file format. A custom
  607. ;  door information file format is defined using the "CustomFileName" command,
  608. ;  followed by one or more lines beginning with the "CustomFileLine" command.
  609. ;
  610. ;  The "CustomFileName" option specifies the filename used to distinguish this
  611. ;  file format from other file formats. This filename should not include a
  612. ;  path. To specify the path where the door information file is located, use
  613. ;  the BBSDir setting, near the beginning of this file. If the filename of the
  614. ;  custom format is the same as that of one of the built-in formats, the custom
  615. ;  format will override the built-in format.
  616. ;
  617. ;  The actual format of the custom file is specified using a number of lines
  618. ;  that begin with the keyword "CustomFileLine". Each of these lines will
  619. ;  correspond to a single line in the door information file, with the option
  620. ;  following the "CustomFileLine" keyword specifying the information that can
  621. ;  be found on that line. This can be one of the following keywords:
  622. ;
  623. ;             Ignore - Causes the next line in the door information
  624. ;                      file to be ignored. Use on lines for which none
  625. ;                      of the options below apply.
  626. ;            ComPort - COM? port the modem is connected to
  627. ;                      (0 indicates local mode)
  628. ;         FossilPort - Fossil port number the modem is connected to
  629. ;           ModemBPS - BPS rate at which to communicate with modem
  630. ;                      (0 or non-numerical value indicates local mode)
  631. ;          LocalMode - 1, T or Y if door is operating in local mode
  632. ;           UserName - Full name of the user
  633. ;      UserFirstName - First name(s) of the user
  634. ;       UserLastName - Last name of the user
  635. ;              Alias - The user's psuedonym / handle
  636. ;          HoursLeft - Hours user has left online
  637. ;        MinutesLeft - Minutes user has left online, or time left online
  638. ;                      in format hh:mm
  639. ;        SecondsLeft - Seconds user has left online, or time left online
  640. ;                      in format hh:mm:ss or format mm:ss
  641. ;                      (If more than one of the above time options are
  642. ;                      used, the user time left is taken to be the total
  643. ;                      of all of these values.)
  644. ;               ANSI - 1, T, Y or G for ANSI graphics mode
  645. ;             AVATAR - 1, T or Y for AVATAR graphics mode
  646. ;                RIP - 1, T or Y for RIP graphics mode
  647. ;        PagePausing - 1, T or Y if user wishes a pause at end of screen
  648. ;       ScreenLength - Number of lines on user's screen
  649. ;     ScreenClearing - 1, T or Y if screen clearing mode is on
  650. ;           Security - The user's security level / access level
  651. ;               City - City the user is calling from
  652. ;               Node - Node number user is connected to
  653. ;          SysopName - Full name of the sysop
  654. ;     SysopFirstName - The sysop's first name(s)
  655. ;      SysopLastName - The sysop's last name
  656. ;         SystemName - Name of the BBS
  657. ;
  658. ;
  659. ;CustomFileName    EXAMPLE.DEF; Same format as DORINFO?.DEF
  660. ;CustomFileLine    SystemName
  661. ;CustomFileLine    SysopFirstName
  662. ;CustomFileLine    SysopLastName
  663. ;CustomFileLine    ComPort
  664. ;CustomFileLine    ModemBPS
  665. ;CustomFileLine    Ignore
  666. ;CustomFileLine    UserFirstName
  667. ;CustomFileLine    UserLastName
  668. ;CustomFileLine    City
  669. ;CustomFileLine    ANSI
  670. ;CustomFileLine    Security
  671. ;CustomFileLine    MinutesLeft
  672. ;
  673. ;------------------------------------------------------------------------------
  674.  
  675.  
  676.  
  677.  
  678. =============================================================================
  679.                               REGISTRATION
  680. =============================================================================
  681.  
  682.      What you get when you register:
  683.  
  684.            Up to 12 active messages.
  685.          No "unregistered" message.
  686.          Your Key will work on ALL future versions of ZMessage.
  687.            The number to my BBS for tecnical support.
  688.          My undying gratitude.
  689.          You sleep better at night.
  690.            The Aliens won't suck your brain.
  691.  
  692.      To register ZMessage, simply fill out the registration form included
  693. in this archive and send it with a check or money order payable to KS\ 
  694. Software to the following address:
  695.  
  696. KS\ Software
  697. PO BOX 341
  698. Parkton, NC 28371
  699.  
  700. <Sorry No Credit Cards yet>
  701.  
  702.    Once you recieve your registration code, edit the configuration file
  703. to reflect your registration code and the program will unlock the registered
  704. version capabilities.
  705.  
  706.  
  707. ===========================================================================
  708.                       GETTING THE NEWEST VERSION
  709. ===========================================================================
  710.   The most updated version of Zmessage is available for download on the 
  711. following Official Beta Sites:
  712.  
  713. Apache BBS (910) 497-5451  fido 1:3634/302
  714.  
  715. TLC BBS (910) 868-2099
  716.  
  717. RaZoR's EdGe BBS (910) 904-0029
  718.  
  719.   The newest version of ZMessage can can also be obtained through FidoNet
  720. file request at 1:3634/406 filename ZMESSAGE 24 hours/day except NMH.  
  721.  
  722. ===========================================================================
  723.                               CREDITS
  724. ===========================================================================
  725.  
  726. Special thanks goes out to the Beta Team:
  727.  
  728. Cruser -n- Heather  <-Apache BBS (910) 497-5451->  1:3634/302
  729.  
  730. Little Sister  <-TLC BBS (910) 868-2099->
  731.  
  732. HereticX16   <-RaZoR's EdGe BBS (910) 904-0029->
  733.  
  734. Special thanks goes out to HereticX16 for figuring out how to get Zmessage
  735. to run with Renegade.  Thanks for the doc man!  and of course Brian Pirie
  736. for the OPEN DOORS programming library.  Open Doors Vs. 5.0 is available at
  737. any BBS filename ODOORS50.ZIP, or you can FREQ ODOORS from 1:243/8 via
  738. FidoNet. 
  739.  
  740. ==========================================================================
  741.                            REVISION HISTORY
  742. ==========================================================================
  743. 1.0
  744.       It Starts....
  745.  
  746. 1.1
  747.       Major Bug Fixes. Added Message Content Confirmation and Posted Message
  748.       dialog.
  749.  
  750. 1.20
  751.       Smashed stupid bug.
  752.  
  753.       Added ability to limit maximum number of messages in configuration file.
  754.     
  755. 2.0b1
  756.       Now has internal comm routines. No more need for fossil.
  757.  
  758.       Added multiline support! 
  759.  
  760.       Added ability to embed colors.
  761.     
  762. 2.0b2
  763.       Completely overhauled the look and feel of ZMessage.
  764.  
  765.       Added a "normal" door mode with menu driven interface for calling from
  766.       inside the BBS
  767.            
  768.       Revamped data file to allow for unlimited embedded colors, and up to
  769.       12 messages instead of 9.
  770.  
  771.       Added RIP
  772.  
  773.       Squashed the "Chinese" bug!
  774.  
  775.       Rensetup.doc added to the archive.
  776.  
  777. 2.0b3 Wide Beta 
  778.     
  779.     RIP Autodetect actually works now!
  780.  
  781.     Added ability to restrict users below a certain access level from
  782.     posting.
  783.  
  784.         Prior to this version a configuration file was required for all
  785.         nodes.  Now node specific data such as dropfile path and odd
  786.         IRQ's are now set on the command line and only one configuration
  787.         file is required to set the rest of the door configuration
  788.         options.
  789.  
  790. THE FUTURE.......
  791.  
  792. On the drawing board are the following items for future revisions.
  793.  
  794. A Parser to implement naughty and nice mode of operation.
  795.  
  796. A trash can file for those who need to be there.
  797.  
  798.      If there is anything you would like to see implemented or changed in
  799. ZMessage, please E-Mail me with your comments.  Again, my E-Mail address is
  800.  
  801. FidoNet
  802.   1:3634/406
  803.  
  804. AOL
  805.  Moutan Man
  806.  
  807. InterNet
  808.  moutanman@aol.com
  809.  
  810. and snail mail
  811.   PO BOX 341
  812.   Parkton, NC 28371
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.